 /*******************************************************************************
  * Copyright (c) 2006 IBM Corporation and others.
  * All rights reserved. This program and the accompanying materials
  * are made available under the terms of the Eclipse Public License v1.0
  * which accompanies this distribution, and is available at
  * http://www.eclipse.org/legal/epl-v10.html
  *
  * Contributors:
  * IBM Corporation - initial API and implementation
  ******************************************************************************/
 package org.eclipse.ui.internal;

 /**
  * This iterface is used to identify and call back to trim elements that can be
  * repositioned to edges other than the one that they're defined as being in by
  * default.
  * <p>
  * NOTE: This class is a part of a 'work in progress' and should not be used
  * without consulting the Platform UI group. No guarantees are made as to the
  * stability of the API (except that the javadoc will get better...;-).
  * </p>
  *
  * @since 3.2
  *
  */
 public interface ITrimAreaChangeListener {
     /**
      * If a control's TrimLayoutData has a listener defined then this method
      * will be called whenever the trim changes the orientation (i.e. side) that
      * it's on.
      * <p>
      * The implementation should perform any adjustments to its control
      * necessary to support it in its 'newOrientation' (i.e. changing a ToolBar
      * from horizontal to vertical if it's been redocked to an area on the left
      * or right side)
      * </p>
      *
      * @param oldOrientation
      * The SWT side that the trim was previously on.
      * @param newOrientation
      * The SWT side that the trim has been repositioned to
      */
     public void areaChanged(int oldOrientation, int newOrientation);
 }

